SherbyNet - /page/wikibook/entry.mu

<!DOCTYPE html>

<title>Insert (SQL)</title>

</head>

<h1 id="firstHeading" class="firstHeading mw-first-heading">Insert (SQL)</h1>

</header>

</div>

<div id="mw-content-text" class="mw-body-content mw-content-ltr" lang="fr" dir="ltr"><div class="mw-content-ltr mw-parser-output" lang="fr" dir="ltr"><code>INSERT</code> est une commande <a href="Structured_Query_Language" title="Structured Query Language">SQL</a> qui ajoute un ou plusieurs <a href="https://fr.wiktionary.org/wiki/tuple" class="extiw external" title="wikt:tuple">tuples</a> dans une <a href="Table_(base_de_donn%C3%A9es)" title="Table (base de données)">table</a> d'une <a href="Base_de_donn%C3%A9es_relationnelle" title="Base de données relationnelle">base de données relationnelle</a>.

<div class="mw-heading mw-heading2"><h2 id="Forme_basique">Forme basique</h2></div>

La commande INSERT a la syntaxe suivante :

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO table (column1 [, column2, column3 ... ]) VALUES (value1 [, value2, value3 ... ])

</pre></div>

Le nombre de colonnes doit être identique au nombre de valeurs. Si une colonne n'est pas spécifiée, sa valeur par défaut lui sera affectée. Les valeurs insérées doivent respecter toutes les contraintes tel que les <a href="Cl%C3%A9_%C3%A9trang%C3%A8re" title="Clé étrangère">clés étrangères</a>, <a href="Cl%C3%A9_primaire" title="Clé primaire">clés primaires</a>, et les colonnes NOT NULL. Si la commande contient une erreur de syntaxe, ou si une contrainte n'est pas respectée, les valeurs ne sont pas insérées et une erreur est rapportée.

Exemple :

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast (firstname, lastname) VALUES ('Raoul', 'Duke')

</pre></div>

Une écriture plus concise existe, sans nommer les colonnes, insérant les valeurs dans le même ordre que les colonnes de la table. Il n'est pas nécessaire de préciser toutes les colonnes, les colonnes restantes prendront leurs valeurs par défaut.

Syntaxe :

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO table VALUES (value1, [value2, ... ])

</pre></div>

L'exemple précédent peut donc être réecrit, si et seulement si les deux premières colonnes de la table film_cast sont firstname et lastname:

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast VALUES ('Raoul', 'Duke');

</pre></div>

<div class="mw-heading mw-heading2"><h2 id="Formes_avancées">Formes avancées</h2></div>

<div class="mw-heading mw-heading3"><h3 id="Insertion_multiples">Insertion multiples</h3></div>

Depuis SQL-92 <a href="https://en.wikipedia.org/wiki/SQL-92" class="extiw external" title="en:SQL-92">(en)</a> il est possible d'insérer plusieurs tuples en une seule requête :

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO table (column-a, [column-b, ...])

VALUES ('value-1a', ['value-1b', ...]),

('value-2a', ['value-2b', ...]),

...

</pre></div>

Cette fonctionnalité est supportée par <a href="IBM_Db2" title="IBM Db2">DB2</a>, <a href="Microsoft_SQL_Server" title="Microsoft SQL Server">SQL Server</a> (Depuis la version 10.0), <a href="PostgreSQL" title="PostgreSQL">PostgreSQL</a> (depuis la version 8.2), <a href="MySQL" title="MySQL">MySQL</a>, <a href="SQLite" title="SQLite">SQLite</a> (depuis la version 3.7.11) et <a href="H2_(base_de_donn%C3%A9es)" title="H2 (base de données)">H2</a>.

Exemple (considérant que 'firstname' et 'lastname' sont les deux seules colonnes de la table 'film_cast'):

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast VALUES ('Raoul', 'Duke'), ('Dr.', 'Gonzo')

</pre></div>

Les insertions multiples sont particulièrement intéressantes en matière de performances. Il est donc conseillé pour une application qui doit insérer beaucoup lignes par seconde d'utiliser des requêtes multiples pour réduire le nombre de requêtes effectuées et la charge du serveur. L'utilisation de requête multiples permet d'insérer plus de tuples qu'une série d'insertions simples pour un temps donné.

Afin d'insérer plusieurs tuples en utilisant MS SQL, la construction suivante est utilisable :

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast

SELECT 'Raoul', 'Duke'

UNION ALL

SELECT 'Dr.', 'Gonzo'

</pre></div>

Cependant ce n'est pas une requête SQL valide selon le standard SQL:2023 <a href="https://en.wikipedia.org/wiki/SQL:2023" class="extiw external" title="en:SQL:2023">(en)</a> dû à la sous requête SELECT incomplète.

Il est aussi possible de le faire sous Oracle en utilisant la <a href="Table_DUAL" title="Table DUAL">table DUAL</a>:

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast

SELECT 'Raoul', 'Duke' FROM DUAL

UNION ALL

SELECT 'Dr.','Gonzo' FROM DUAL

</pre></div>

Une implémentation respectant les standards SQL:

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast

SELECT 'Raoul', 'Duke' FROM LATERAL ( VALUES (1) ) AS t(c)

UNION ALL

SELECT 'Dr.','Gonzo' FROM LATERAL ( VALUES (1) ) AS t(c)

</pre></div>

Oracle <a href="PL/SQL" title="PL/SQL">PL/SQL</a> supporte la syntaxe "INSERT ALL", dans laquelle les requêtes d'insertions multiples sont terminés par un SELECT<a href="#cite_note-1">[1]</a>:

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT ALL

INTO film_cast VALUES ('Raoul', 'Duke')

INTO film_cast VALUES ('Dr.', 'Gonzo')

SELECT * FROM DUAL

</pre></div>

Avec la base de données <a href="Firebird_(base_de_donn%C3%A9es)" title="Firebird (base de données)">Firebird</a>, l'insertion multiple est possible grâce à la syntaxe :

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast ("firstname", "lastname")

SELECT 'Raoul', 'Duke' FROM RDB$DATABASE

UNION ALL

SELECT 'Dr.', 'Gonzo' FROM RDB$DATABASE

</pre></div>

Cependant, Firebird restreint le nombre de tuples qui peuvent être insérés par cette syntaxe dû à la limite du nombre de contextes utilisables en une seule requête.

<div class="mw-heading mw-heading3"><h3 id="Copier_des_tuples_depuis_une_autre_table">Copier des tuples depuis une autre table</h3></div>

Une seule requête INSERT peut aussi être utilisée pour récupérer des données depuis une autre table, les modifier si nécessaire, puis les insérer directement dans une table. Dans ce cas, une sous-requête est utilisée à la place de la clause VALUES :

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast2 ( firstname, lastname )

SELECT firstname, lastname

FROM film_cast

WHERE firstname IN ('Raoul', 'Dr.')

</pre></div>

<div class="mw-heading mw-heading2"><h2 id="Récupération_de_la_clef_primaire">Récupération de la clef primaire</h2></div>

Il est souvent nécessaire d'obtenir la <a href="Cl%C3%A9_artificielle" title="Clé artificielle">cle primaire artificielle</a> qui a été auto-générée par le <a href="Moteur_de_base_de_donn%C3%A9es" title="Moteur de base de données">moteur de base de données</a> lors d'une insertion afin de l'utiliser dans des requêtes suivantes. Il existe, en fonction du moteur utilisé, différentes méthodes pour l'obtenir :

<ul><li>En utilisant une <a href="Proc%C3%A9dure_stock%C3%A9e" title="Procédure stockée">procédure stockée</a> spécifique au moteur de base de données tel que SCOPE_IDENTITY() en SQL Server, ou last_insert_rowid() en SQLite.</li></ul>

<ul><li>En utilisant une requête SELECT spécifique au moteur de base de données sur une table temporaire contenant le dernier tuple inséré. DB2 implémente cette fonctionnalité de la manière suivante :</li></ul>

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>SELECT *

FROM NEW TABLE (

INSERT INTO film_cast

VALUES ('Raoul', 'Duke')

) AS t

</pre></div>

<dl><dd>DB2 pour <a href="Z/OS" title="Z/OS">z/OS</a> implémente cette fonctionnalité de la manière suivante :</dd></dl>

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>SELECT *

FROM FINAL TABLE (

INSERT INTO film_cast

VALUES ('Raoul', 'Duke')

)

</pre></div>

<ul><li>En effectuant une requête <a href="Select_(SQL)" title="Select (SQL)">SELECT</a> après l'INSERT avec une fonction spécifique à la base de données qui renvoie la clef primaire générée pour la dernière insertion effectuée, tel que LAST_INSERT_ID() pour <a href="MySQL" title="MySQL">MySQL</a>.</li>

<li>En utilisant la syntaxe OUTPUT lors de la requête d'insertion, avec MS-SQL Server 2005 et MS-SQL Server 2008.</li>

<li>En utilisant le mot clé RETURNING avec <a href="Oracle_Database" title="Oracle Database">Oracle</a> :</li></ul>

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast VALUES ('Raoul', 'Duke')

RETURNING film_cast_id INTO v_pb_id

</pre></div>

<ul><li>En utilisant le mot clef RETURNING avec <a href="PostgreSQL" title="PostgreSQL">PostgreSQL</a> (depuis la version 8.2). Le résultat est identique au résultat d'un <a href="Select_(SQL)" title="Select (SQL)">SELECT</a>.</li></ul>

<a href="Firebird_(base_de_donn%C3%A9es)" title="Firebird (base de données)">Firebird</a> utilise la même syntaxe, cependant la requête ne pourra insérer qu'un seul tuple<a href="#cite_note-2">[2]</a>.

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>INSERT INTO film_cast VALUES ('Raoul', 'Duke')

RETURNING film_cast_id

</pre></div>

<ul><li>En utilisant la fonction IDENTITY() avec <a href="H2_(base_de_donn%C3%A9es)" title="H2 (base de données)">H2</a> :</li></ul>

<div class="mw-highlight mw-highlight-lang-sql mw-content-ltr" dir="ltr"><pre>SELECT IDENTITY()

</pre></div>

<div class="mw-heading mw-heading2"><h2 id="Déclencheurs_(Triggers)">Déclencheurs (Triggers)</h2></div>

Si des <a href="D%C3%A9clencheur" title="Déclencheur">déclencheurs</a> (triggers en anglais) sont définis sur la table dans laquelle la requête insère, ils seront exécutés dans le contexte de la requête. BEFORE INSERT permet la modification des valeurs qui devront être insérées, AFTER INSERT ne peut plus modifier les données mais peut être utilisé pour initier des actions sur d'autres tables.

<div class="mw-heading mw-heading2"><h2 id="Articles_connexes">Articles connexes</h2></div>

<ul><li><a href="Select_(SQL)" title="Select (SQL)">Select (SQL)</a></li>

<li><a href="Update_(SQL)" title="Update (SQL)">Update (SQL)</a></li>

<li><a href="Delete_(SQL)" title="Delete (SQL)">Delete (SQL)</a></li></ul>

<div class="mw-heading mw-heading2"><h2 id="Notes_et_références">Notes et références</h2></div>

<li id="cite_note-1"><a href="#cite_ref-1">↑</a> <abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="http://psoug.org/snippet/Oracle-PL-SQL-INSERT-ALL_589.htm"><cite style="font-style:normal;" lang="en">Oracle PL/SQL: INSERT ALL</cite></a> », psoug.org (consulté le <time class="nowrap" datetime="2010-09-02" data-sort-value="2010-09-02">2 septembre 2010</time>)

</li>

<li id="cite_note-2"><a href="#cite_ref-2">↑</a> <abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="http://www.firebirdsql.org/file/documentation/reference_manuals/reference_material/html/langrefupd25-insert.html#langrefupd25-insert-returning"><cite style="font-style:normal;" lang="en">Firebird 2.5 Language Reference Update</cite></a> » (consulté le <time class="nowrap" datetime="2011-10-24" data-sort-value="2011-10-24">24 octobre 2011</time>)

</li>

</ol></div>

</div>

</div>

<ul id="bandeau-portail" class="bandeau-portail"><li> Portail des bases de données </li> </ul></div><div><div class="zim-footer">

Cet article est issu de <a class="external text" title="Dernière modification le 2024-11-06" href="https://fr.wikipedia.org/wiki/?title=Insert_(SQL)&oldid=220068221">Wikipédia</a>. Sauf mention contraire, le texte est disponible sous <a class="external text" href="https://creativecommons.org/licenses/by-sa/4.0/deed.fr">Creative Commons Attribution-Share Alike 4.0</a>. Des conditions supplémentaires peuvent s’appliquer aux fichiers multimédias.

</div>

</div></div>

</div>

</main>

</div>

</body></html>